home *** CD-ROM | disk | FTP | other *** search
/ Amoszine 2 / Amoszine 2.adf / Enhanced_music_ext / EME.doc < prev   
Text File  |  1992-02-26  |  11KB  |  210 lines
  1. ------------------------------------------------------------------------------
  2.             **   **   **  ***   ***    *****    **    ***  **  ****
  3.            ****  *** *** ** ** **  *   **  **  ****  **  * ** **  **
  4.           **  ** ** * ** ** ** **      **  ** **  ** **    ** **
  5.           **  ** ** * ** ** **  ***    *****  **  **  ***  ** **
  6.           ****** **   ** ** **    **   **  ** ******    ** ** **
  7.           **  ** **   ** ** ** *  **   **  ** **  ** *  ** ** **  **
  8.           **  ** **   **  ***   ***    *****  **  **  ***  **  ****
  9. ------------------------------------------------------------------------------
  10.                   Enhanced Music Extension v3.0 DEMOVERSION
  11.  
  12.                             Written by Paul Reece
  13.  
  14.                        Old Extension by François Lionet
  15.  
  16.                           © Stealth Productions 1993
  17.  
  18.                 This extension was written using Devpac v2.15
  19.  
  20.      --- This is compatible with AMOS 1.3 and AMOS Professional only ---
  21.  
  22. ------------------------------------------------------------------------------
  23.                               !IMPORTANT NOTICE!
  24. ------------------------------------------------------------------------------
  25. This  extension  may not be distributed in any way without written permission.
  26. It  is  NOT public domain, freeware, shareware etc.  The copyright is retained
  27. by the author.
  28.  
  29. This  DEMOVERSION  may be freely distributed as long as all files are included
  30. in full and are not altered in any way.
  31.  
  32. I do not take any responsibility for loss of data etc arising from use of this
  33. program.  USE AT YOUR OWN RISK!!!
  34. ------------------------------------------------------------------------------
  35. This  extension  was originally written as a bugfix for the old Amos 1.3 music
  36. extension  v1.54.   As  the  bugs  were  fixed in the extension, new bugs were
  37. discovered  so in the end, a full re-working of the tracker music routines was
  38. done.   The  old playroutine was replaced with a newer Protracker playroutine,
  39. new  tracker  commands  were  added  and  the  file loading was improved.  Med
  40. support was also added.
  41.  
  42. To  install the extension, copy the file Music.lib over the existing Music.lib
  43. file in your AMOS_SYSTEM folder.
  44.  
  45. In  the  case  of  AMOS Pro, copy the file AMOSPro_Music.lib over the existing
  46. file in your APSystem folder.
  47.  
  48. This  extension  features  all of the original Amos music commands and the new
  49. commands  listed  below.   The  AmosPro version also features the AmosPro only
  50. music commands featured in AmosPro.
  51.  
  52. In  this  DEMOVERSION,  the track sample command has been disabled and the med
  53. play  and  track  play  commands can only be used 3 times.  No such limits are
  54. included in the full version.
  55. ------------------------------------------------------------------------------
  56. ------------------------------------------------------------------------------
  57.    *** Soundtracker/Noisetracker/Protracker/Startrekker VBlank Routines ***
  58.                        Supports only 31 sample modules
  59.            
  60.                   Now supports ALL Protracker 3.10 commands!
  61.   (does not support Protracker CIA tempo commands or Startrekker AM modules)
  62. ------------------------------------------------------------------------------
  63. ------------------------------------------------------------------------------
  64. Track Load "fname",<bank>                   Modified Command
  65.  
  66. Loads the specified module into memorybank <bank>.
  67. ------------------------------------------------------------------------------
  68. Track Play <bank>                           Modified Command
  69. Track Play <bank>,<position>
  70.  
  71. Plays  a  previously  loaded  tracker  module  stored  in bank <bank>.  If the
  72. <position> option is used, the module will start from the specified position.
  73. ------------------------------------------------------------------------------
  74. Track Stop                                  Modified Command
  75.  
  76. Stops the module currently playing.
  77. ------------------------------------------------------------------------------
  78. Track Loop On                               Modified Command
  79. Track Loop Of
  80.  
  81. When  on,  this command tells the playroutine to repeat the next song until it
  82. is stopped.  If this command is not used, the song will stop at its end UNLESS
  83. a pattern jump command is used in the last pattern.
  84. In  the original Amos Pro music extension, both of these commands led straight
  85. to an RTS instruction (it did absolutely nothing!!).  This just shows how much
  86. testing software houses actually do!
  87. ------------------------------------------------------------------------------
  88. Patt Loop On                                New Command
  89. Patt Loop Of
  90. Patt Loop No
  91.  
  92. Forces  the  currently  playing pattern to repeat.  If used before Track Play,
  93. the  specified  pattern  will  be  repeated.   (this also happens to the first
  94. pattern  if  no  pattern  number  is  specified)  If Patt Loop No is used, the
  95. pattern played next will play once and the music will stop.
  96. ------------------------------------------------------------------------------
  97. Track Tempo <tempo>                         New Command
  98.  
  99. Sets the tempo of the module currently playing.  The number in <tempo> is just
  100. like the number in the tempo command in any tracker.  Tempo 0 is the fastest.
  101. Tempo 6 is the default.
  102.  
  103. This  command  does  not over-ride the tempo commands used in the module.  ie.
  104. if  you  set  a  tempo, it will be changed by any tempo commands in the music.
  105. (eg.  F03)
  106.  
  107. This command is useful if you start a module part way through and the tempo is
  108. incorrect.
  109. ------------------------------------------------------------------------------
  110. Track Sample On                    New Command
  111. Track Sample Off                            NOT IN DEMO VERSION!!!
  112.  
  113. This  command turns off tracker channel 4 (Left channel) while playing tracker
  114. modules.  This allows you to use the spare channel for playing samples without
  115. the samples being affected by the playroutine in any way.
  116. ------------------------------------------------------------------------------
  117. =Trpos                         New Command
  118.  
  119. Returns the position of the currently playing module.  0 is the first position
  120. and so on.
  121. ------------------------------------------------------------------------------
  122. =Trlen                                      New Command
  123.  
  124. Returns  the  position  length of the currently playing module.  If the length
  125. returned is 34, the last position played would be 33.
  126. ------------------------------------------------------------------------------
  127. =TrPat(pos)                                 New Command
  128.  
  129. Returns the pattern number played at song position pos.
  130. ------------------------------------------------------------------------------
  131. =Trstat                                     New Command
  132.  
  133. Returns 1 if the song is still playing.  0 if it has finished.
  134. ------------------------------------------------------------------------------
  135. =VuMeter(chan)                              Modified Command
  136.  
  137. This  command  finally  supports tracker modules.  It is impossible to include
  138. support for Octamed Pro in this command as it is an external library.
  139. ------------------------------------------------------------------------------
  140. ------------------------------------------------------------------------------
  141.                   *** Octamed Pro - Med Support Routines ***
  142.                      Supports both MMD0 and MMD1 modules.
  143.                             4 channel modules ONLY
  144.                 Requires Medplayer Library Version 2 or better
  145. ------------------------------------------------------------------------------
  146. ------------------------------------------------------------------------------
  147. Med Load "fname",bank                       New Command
  148.  
  149. This  loads  the Med or Octamed module specified into memory bank <bank>.  Med
  150. modules  are  not  saved  along  with your programs.  They must be loaded from
  151. disk.
  152.  
  153. This  command  only  works  if Medplayer.library v2.0 is in your current LIBS:
  154. directory.  If the library cannot be found, an appropriate error will occur.
  155. ------------------------------------------------------------------------------
  156. Med Play bank                               New Command
  157. Med Play bank,modnum                        CRIPPLED IN DEMO VERSION
  158.  
  159. This  command plays the currently loaded module.  The <modnum> parameter plays
  160. the  module  number  specified (multi modules only!!).  The first module is 0,
  161. the second is 1 and so on.
  162. ------------------------------------------------------------------------------
  163. Med Stop                                    New Command
  164.  
  165. This command stops playing any med module currently playing.
  166. ------------------------------------------------------------------------------
  167. Med Cont                                    New Command
  168.  
  169. This command re-starts any stopped module from where it was stopped.
  170. ------------------------------------------------------------------------------
  171. Med Midi On                                 New Command
  172.  
  173. If this command is used before starting a module, any midi information will be
  174. sent to your midi instrument.
  175. ------------------------------------------------------------------------------
  176. Med Tempo <tempo>                           New Command
  177.  
  178. Technically  this command sets the tempo of the currently playing module.  For
  179. some odd reason it fails to work.  It should work!  There seems to be a bug in
  180. the library.
  181. ------------------------------------------------------------------------------
  182. ------------------------------------------------------------------------------
  183. The  OctamedPro/Med routines can be updated at any time by replacing medplayer
  184. library with the newest available version.
  185.  
  186. Do  you have any suggestions for this program???  Have you found a bug?  or do
  187. you just want to write mail??  (I LOVE MAIL!!) - If so, just contact me at one
  188. of the following addresses:
  189.  
  190. Snailmail:    Paul Reece
  191.  
  192.         3 Weston Place
  193.         Glenorchy, Tasmania.
  194.         Australia. 7010
  195.  
  196. Email:        preece@slick.clare.tased.edu.au     (Preferred)
  197.                 paul_ree@asgard.clare.tased.edu.au   
  198.         ds041@cleveland.freenet.edu
  199.  
  200.  
  201. The  full  version  of  this program will hopefully be distributed on an Amiga
  202. Format coverdisk by the end of 1993.
  203. ------------------------------------------------------------------------------
  204.                 Amos and Amos Pro are (c) Europress Software.
  205.      Octamed/Octamed Pro/Med and Medplayer.library are (c) Teijo Kinnunen
  206.  
  207.  The Enhanced Music Extension is (c) 1993 - Paul Reece of Stealth Productions
  208. ------------------------------------------------------------------------------
  209.                             **** END OF FILE ****
  210.